home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / WWW / INTERGIF.SPK / !InterGif / !Help < prev    next >
Text File  |  1997-11-08  |  14KB  |  331 lines
  1.  
  2.                     InterGif 6.02
  3.                     =============
  4.  
  5.         by Peter Hartley (K) All Rites Reversed
  6.     Desktop front-end adapted from one by Iain Logan
  7.  
  8. INTERGIF 6.02 is a program for making GIF images from 2-, 4-, 16-
  9. or 256-colour RiscOS sprite files, or from Draw files, or from
  10. files produced with Iota Software's (commercial) animation
  11. program The Complete Animator. It can also convert from GIFs back
  12. to sprites, and can also be used as an optimiser for animated
  13. GIFs prepared in other programs.
  14.  
  15.  
  16.         Get the latest version
  17.         ----------------------
  18.  
  19. The latest version of InterGif, plus more help information and
  20. full source code for various platforms, is always available on
  21. the World-Wide Web at the address
  22.         http://www.ant.co.uk/~peter/software/intergif.htm
  23. It's the eighth of November, 1997, as I'm writing these words
  24. (happy birthday, Grandma): if it's long after that that you're
  25. reading them, you might want to see if there's a later version
  26. now available.
  27.  
  28.  
  29.         Distribution
  30.         ------------
  31.  
  32. InterGif is NOT COPYRIGHTED and is NOT distributed under the GNU
  33. General Public Licence. For full information read the file
  34. !InterGif.Copying or go to the Web site.
  35.     InterGif is mine: in particular, it doesn't belong to ANT
  36. Limited. If it gets anything wrong, it's my problem, not theirs.
  37.     Versions 6 and later of InterGif contain (a small piece of)
  38. code developed by the Independent JPEG Group. (The "Find best
  39. palette" routine, if you must know.)
  40.     In order to convert Draw files you will need Acorn's Drawfile
  41. module. This is not included in InterGif distributions, but is
  42. available from
  43.         ftp://ftp.acorn.co.uk/
  44.  
  45.  
  46.         Features
  47.         --------
  48.  
  49.   o InterGif runs either on the desktop, or from the command line
  50.     (so I can produce the GIFs for my own Web pages, from the
  51.     sprites which constitute their source, using a make file!).
  52.  
  53.   o InterGif has options for the transparency and interleaving
  54.     features of GIF89a.
  55.  
  56.   o InterGif can take a sprite file (or an Animator file)
  57.     containing several frames, and produce from it an animated
  58.     GIF which Netscape 2.0 or later, MSIE 3.0beta1 or later, or
  59.     ANT Fresco 1.22 or later will render as animated if it's
  60.     inlined in a Web page. The animation delay can be set
  61.     individually for each frame, or for the whole animation.
  62.  
  63.   o InterGif will reduce its input to a smaller number of colours
  64.     (unless you explicitly tell it not to) if it can get away
  65.     with it, i.e. if only that many of the colours are used
  66.     anyway.
  67.  
  68.   o It will also compress only the rectangle which has changed on
  69.     each frame, so if your animation has a complex but stationary
  70.     background, the background will only get compressed once.
  71.     Deviousness and cunning are employed to minimise the final
  72.     size of the GIF: so much so that many animated GIFs I've
  73.     found on the Web have ended up smaller when run through
  74.     InterGif.
  75.  
  76.   o It can also make GIF images from Draw files. It uses, for
  77.     this, the same code that is in my AADraw program (see end),
  78.     which means it produces GIFs or sprites with a 216-colour
  79.     cube palette (as used on Macintoshes and by Netscape and MSIE
  80.     for Windows), *not* the standard Acorn 256-colour palette.
  81.     (For AADraw connoisseurs, I'll add that you don't get the -b
  82.     feature of that program: InterGif always anti-aliases to
  83.     white.)
  84.  
  85.   o InterGif 6 lets you forcibly reduce a GIF's palette to the
  86.     standard Acorn 256-colour palette, or to a 216-entry colour
  87.     cube (as used on the Macintosh and by most Windows browsers),
  88.     or to a palette file you supply. Alternatively, it can
  89.     calculate the best palette for displaying the GIF, and then
  90.     reduce to that. (This is not the same as the colour reduction
  91.     InterGif has always had: it is lossy and you should keep
  92.     copies of your unmapped originals.)
  93.  
  94.  
  95.         Desktop use
  96.         -----------
  97.  
  98. Pretty straightforward. Run !InterGif; drag your sprite file,
  99. Animator file, Draw file, or GIF onto the left-hand bit of the
  100. window; set any options you want in the middle bit of the window;
  101. and save your GIF or sprite file out from the right-hand bit of
  102. the window. The options are:
  103.  
  104.   o Interlaced
  105.         Produce an interlaced GIF: in other words, one which a Web
  106.     browser can render quickly at a low resolution, filling in the
  107.     details later as they arrive.
  108.  
  109.   o Looping animation
  110.         Normally an animated GIF plays through once and stops. If
  111.     you tick this option, you'll get an animated GIF that plays
  112.     over and over again. This is a Netscape extension to the GIF
  113.     format, but hopefully it will become a popular one -- both
  114.     MSIE and Fresco now support it too.
  115.  
  116.   o Join input files
  117.         This option causes InterGif to look for only one frame in
  118.     the file you give it, and then look for the next frame in
  119.     another file with the numeric part of the file incremented.
  120.     For instance, you could have three files called frame000,
  121.     frame001, and frame002 and create an three-frame animation by
  122.     dragging frame000 (only) onto the InterGif window and
  123.     choosing "Join input files".
  124.  
  125.   o Set delay
  126.         This lets you set the frame rate, in centiseconds. This
  127.     overrides any frame rate specified in the input file.
  128.         If this is *not* ticked, InterGif's output uses the
  129.     same frame rate as its input. You can change frame delays
  130.     individually in Animator files in the usual way (in Animator,
  131.     press F7) or in sprite files by giving the frames sprite
  132.     names with "delay" in them: for instance, a sprite called
  133.     "037delay25" will be given a delay of 25 centiseconds.
  134.     (Anything before the word "delay" is ignored.)
  135.         If you leave "Set delay" unticked, and the input file
  136.     doesn't specify frame delays, a default of 8 centiseconds per
  137.     frame (12.5 frames per second) is used.
  138.         Note that you can't have different delays for different
  139.     frames if you tick "Set delay"; if you want that, you have to
  140.     set it up in your sprite or Animator file.
  141.  
  142.   o Transparency
  143.         Choose None to get a wholly opaque GIF (no masking), Auto
  144.     to get InterGif to use the sprites' masks (or the film's
  145.     background colour); or you can specify a transparent
  146.     pixel-value directly.
  147.         (Hint: to find out what pixel-value a sprite pixel has,
  148.     load the sprite into Paint, ensure its palette window is
  149.     showing, click Menu over the pixel you want, and choose
  150.     "Paint->Select colour".)
  151.  
  152.   o Trim
  153.         This option causes InterGif to remove wholly transparent
  154.     rows and columns from the edges of the image. This means that
  155.     the output image may be a different size from the input one,
  156.     which is otherwise never the case.
  157.         This option ticks itself automatically if you're making a
  158.     transparent, interlaced GIF: for the reason why, see the
  159.     section "Netscape Communicator" below.
  160.         You probably want to tick this if you're converting a
  161.     Draw file, as these often end up with one or two transparent
  162.     rows and columns at the edges.
  163.  
  164.   o Split output
  165.         This splits up the input file into one output file per
  166.     frame. Not, I admit, terribly useful, unless you need to
  167.     import something into an application that expects lots of
  168.     one-frame GIFs -- for instance, Sun's Java Animator applet.
  169.     The names of the files are taken from the one you give, with
  170.     any numeric part incremented as needed, so if you save a
  171.     three-frame animation as frame001/gif, you also get
  172.     frame002/gif and frame003/gif.
  173.  
  174.   o Web site
  175.         Clicking on this button takes you to my Web pages on ANT
  176.     Limited's server, as described above. For this to work, you
  177.     need to be connected to the Internet, and also have a Web
  178.     browser loaded which understands ANT's URL broadcast message
  179.     -- for example, Fresco or ArcWeb. (Probably the others too,
  180.     these days.)
  181.  
  182.   o Palette
  183.         This icon opens the Palette Options window, giving you
  184.     the following further options:
  185.  
  186.       o Use existing
  187.             This does the same as previous versions of InterGif:
  188.         it discards palette entries that aren't actually used,
  189.         but keeps all the others.
  190.  
  191.       o Acorn standard 256
  192.       o 216 cube
  193.             These map all colours in the input onto the nearest
  194.         ones in either the standard Acorn 256-colour "mode 15"
  195.         palette, or the Macintosh/PC standard 216-entry colour
  196.         cube. This is useful, for instance, for reducing the size
  197.         of 256-greyscale images.
  198.  
  199.       o From file
  200.             You can also map colours to those in any Acorn
  201.         palette file (such as one saved from !Paint).
  202.  
  203.       o Find best
  204.             This is the most powerful option: selecting this
  205.         makes InterGif calculate the optimal palette for
  206.         displaying the input images, and then map to that. You
  207.         can tell it to calculate any size palette from 2 to 256
  208.         entries. InterGif uses the "median cut" algorithm to
  209.         calculate the palette.
  210.  
  211.  
  212.         Command-line use
  213.         ----------------
  214.  
  215. The !Boot file of !InterGif sets up Alias$intergif, so you no
  216. longer need to copy the intergif file into your library
  217. directory.
  218.     At its simplest, you can just type intergif and the name of
  219. your sprite or film file, and it'll be converted. Here's a full
  220. list of the options:
  221.  
  222. intergif [-i] [-loop] [-s ] [-split] [-d cs] [-t [pixel]] [-trim] [-join]
  223.          [-216 | -256 | -pal palfile | -best n ]
  224.          [-o outfile] infile
  225.  
  226.     -i
  227.         Produce an interlaced GIF
  228.     -loop
  229.         Looping animation
  230.     -s
  231.         Produce a sprite rather than a GIF
  232.     -join
  233.         Join several input files
  234.     -split
  235.         One frame per file
  236.     -d cs
  237.         Frame delay in centiseconds
  238.     -t
  239.         Use automatic transparency (default is no transparency)
  240.     -t pixel
  241.         Use specified pixel as transparent
  242.     -trim
  243.         Remove any transparent border
  244.     -216
  245.         Map to Macintosh/PC colour-cube palette
  246.     -256
  247.         Map to Acorn mode 15 palette
  248.     -pal palfile
  249.         Map to given palette
  250.     -best n
  251.         Find best n-colour palette and map to that (2<=n<=256)
  252.     -o outfile
  253.         Filename for the output (default is <infile>/gif)
  254.     infile
  255.         A RiscOS sprite, Draw, Complete Animator or GIF file
  256.  
  257.  
  258.         Size is important
  259.         -----------------
  260.  
  261. Since at least version 2.02, InterGif has optimised out any
  262. wholly transparent rows and columns at the edges of the first (or
  263. only) frame of transparent GIFs. It does this by setting the size
  264. in the Logical Screen Descriptor to the size of the whole GIF,
  265. and the size in the first Frame Descriptor to the smaller
  266. rectangle which bounds the first frame. This is all completely as
  267. per GIF spec, and is what happens for the second and subsequent
  268. frames of animated GIFs anyway.
  269.     However, some programs which read GIFs (usually those which
  270. either don't understand animations, or don't understand
  271. transparency) incorrectly ignore the LSD size and use the FD
  272. size. These programs include ChangeFSI, Claris HomePage, and
  273. early versions of Fresco (before 1.60). This is a problem as it
  274. can lead to Web authors specifying the wrong WIDTH= and HEIGHT=
  275. attributes in Web pages. All versions of Netscape and MSIE use
  276. the LSD size (at least for GIF89's).
  277.     Early versions of the program "Creator" only set the FD size
  278. and not the LSD size; such images look wrong in MSIE. Netscape
  279. cheats! and uses only the FD size for GIF87 images and
  280. (correctly) the LSD size for GIF89 images. As of version 1.63,
  281. this is Fresco's behaviour too.
  282.  
  283.  
  284.         Netscape Communicator
  285.         ---------------------
  286.  
  287. Some interlaced transparent GIFs made with version 6.01 or
  288. earlier of InterGif may look wrong in Netscape Communicator
  289. (Netscape 4): any that do, should be reconverted with version
  290. 6.02. You may wish to use the new -trim option; if not, your GIF
  291. will be compressed slightly less well than it could be. This is
  292. due to a bug in Netscape 4, not in InterGif. For grody technical
  293. details, read on.
  294.     Netscape 4, in both the Windows and Solaris versions, gets it
  295. wrong if an interlaced image has a border optimised out on the
  296. first frame (in the manner described in "Size is important"
  297. above). The symptom is that black, non-transparent lines appear
  298. every fourth pixel down "transparent" areas of the image. This is
  299. *unquestionably* a bug in Communicator rather than InterGif
  300. (especially in view of the fact that Netscape 3.02 gets it
  301. right), but, powerless as I am in the face of Netscape
  302. Corporation, I've stopped InterGif from optimising out the border
  303. if an interlaced GIF is being made.
  304.     This means that such GIFs end up being compressed less
  305. optimally than they might. If this is a problem (and it may not
  306. be, as interlaced GIFs usually end up compressed less well than
  307. non-interlaced ones anyway) you can use the new -trim option to
  308. *remove*, rather than just avoid compressing, the transparent
  309. border. When using -trim, InterGif's output will *not* be the
  310. same size in pixels as the input image (it is in all other
  311. cases). You can use the HSPACE= and VSPACE= attributes of the
  312. HTML <IMG> tag to produce a transparent border around a trimmed
  313. image.
  314.  
  315.  
  316.         See also
  317.         --------
  318.  
  319.     The InterGif page
  320.         http://www.ant.co.uk/~peter/software/intergif.htm
  321.     The AADraw page
  322.         http://www.ant.co.uk/~peter/software/aadraw.htm
  323.     The Complete Animator
  324.         http://www.iota.co.uk/animator/
  325.     GIF89a specification
  326.         http://asterix.seas.upenn.edu/~mayer/lzw_gif/gif89a.html
  327.  
  328.  
  329.                                                   peter@ant.co.uk
  330.                                                8th November, 1997
  331.